GetTextConverter Function

Creates a TextConverter object for converting between two encodings. It also works if the input encoding and output encoding are the same.

Syntax

result = GetTextConverter( inputEncoding, outputEncoding )

Parameters
inputEncoding	TextEncoding	Input text encoding.
outputEncoding	TextEncoding	Output text encoding.

Notes

In REALbasic, every string may internally have a record of its encoding as well as the bytes that constitute its actual text. In many cases, the encoding is unknown, but any string returned by a TextConverter will have a known encoding, and so will be treated properly by EditFields and Graphics.DrawString. This is why it may sometimes be useful to get a TextConverter where the input and output encodings are the same; it provides a way to make sure that REALbasic knows what encoding a string represents.

Example

The following example converts the text in an EditField:

Dim c as TextConverter
c=GetTextConverter(GetTextEncoding( &h500), GetTextEncoding(0))
EditField2.text=c.convert(EditField1.text)